home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / qmdm_mse.zip / QMOUSE.DOC < prev   
Text File  |  1991-11-03  |  7KB  |  133 lines
  1.  Mouse menu for QMODEM.                                  3/3/91
  2.  
  3.  Files included inthis package:
  4.         QMODEMLT.DEF   -    Source code for Logitech QMODEM mouse menu
  5.         QMODEMLT.MNU   -    Compiled code from Logitech NEWMENU compiler
  6.         QMODEMMS.DEF   -    Source code for Microsoft QMODEM mouse menu
  7.         QMODEMMS.MNU   -    Compiled code from Microsoft MAKEMENU compiler
  8.         QMOUSE.DOC     -    This document
  9.  
  10.  This software (including portions of this DOC file) was originally developed
  11. by Rick Schaefer and I downloaded it from the Forbin Project BBS.
  12.  
  13.  I found the mouse menus developed by Rick extremely easy to use and was
  14. intrigued by the way he had upgraded Bob Rapp's menus so that they matched the
  15. QMODEM screens.  I was challenged by a comment Rick made about needing 12K of
  16. memory for the menu and wondered if there was some way around this "problem".
  17.  
  18.  The answer was to create "flop down" menus instead of "pop up" menus.  If the
  19. pop up menus matched the QMODEM screens so exactly, why bother to have "text"
  20. statements in the menu?  This worked so well, that I was able to reduce the
  21. size of the qmodem.mnu file to just under 4k in size.  This, in turn, allowed
  22. me to implement several other menus that Rick had omitted.
  23.  
  24.  The total number of menus contained in QMODEM.DEF now stands at 34 (up
  25. significantly from Rick's 20) while the size of the compiled menu has
  26. decreased from 10969 bytes to 4943 bytes (4992 bytes for the Microsoft version).
  27.  
  28.  The net effect of not using "text" statements, however, is that the mouse
  29. cursor-block simply appears on the screen.  In some instances it simply
  30. appears in the text on the status line at the bottom of the screen (so you
  31. almost have to know where to look to see it).  Hence, the term "flop down"
  32. menus. 
  33.  
  34.  This necessitated one "minor" change in the way the menu program functions.
  35. When in terminal mode, you must click both buttons TWICE to activate the
  36. mouse "master" command menu.  (Once to display QMODEM's menu and a second time
  37. to activate the mouse.)
  38.  
  39.  Note that two menus DO have "text" statements:  ChgLog (Change (Log) Drive -
  40. Alt-L) and Edit Function Key Entry (Macro2 - Alt-J/1).  QMODEM's Change (Log)
  41. Drive command does not present a menu of choices so the "text" statements do
  42. this for us.  QMODEM's Edit Function Key Entry screen does not suggest some of
  43. the keyword options that can be used in macros; here the "text" statements
  44. provide the prompts.
  45.  
  46.  
  47.  As Rick indicated, the program was written with a two button mouse in mind.
  48. The mouse buttons are very easy to remember:
  49.  
  50.  
  51.      Left Button =   This is Enter when NOT using a menu;
  52.                      when using a menu, this button signifies a menu choice
  53.      Right Button =  This is Escape when NOT using a menu;
  54.                      when using a menu, this button signifies a menu choice
  55.  
  56.      Both Buttons =  Under terminal mode, this activates QMODEM's menu screen;
  57.                      otherwise this activates the mouse menus and de-activates
  58.                      the mouse menus
  59.  
  60.      Mouse up     =  Move hilite bar up
  61.      Mouse Down   =  Move hilite bar down
  62.      Mouse Left   =  Move hilite bar left
  63.      Mouse Right  =  Move hilite bar right
  64.  
  65.  
  66.   For those of you using a color monitor, you might want to edit the QMODEM.DEF
  67. source file changing the "normal" (note lower case) parameters on the "popup"
  68. statements to be the color of your choice.  (Rick's wife seemed to like "2".)
  69. Using "normal" the color of the mouse "cursor" seems to be the color selected
  70. for "Editor Primary Text" in QINSTALL.  (Two exceptions here are the Edit
  71. Function Key Entry (Macro2) and Change (Log) Drive (ChgLog) menus.  Here the
  72. mouse cursor appears to be the color selected for "Screen Text".)
  73.  
  74.  The only maintenance the menus might require (provided that QMODEM does not
  75. relocate any of its' text in future releases) is the disk drives for the "log
  76. disk" selection and the UpLoad & DownLoad selections (menus PgUp and PgDn).
  77.  
  78.  When adding/deleting protocols, be aware that the select statement for the
  79. "default protocol" is first in the list.  Increment/decrement the line number
  80. accordingly and add/delete select statements as appropriate.
  81.  
  82.  IF you remove the ";" from the beginning of the "text" statements (which
  83. will "activate" the text into a "pop up" menu), the size of the qmodem.mnu
  84. program will increase dramatically.  IF you do this AND you are using the
  85. Logitech MENU program, it will be necessary to load the QMODEM menu
  86. with the /nn option to allow the mouse program to operate.  This will reserve
  87. a nnK buffer for the operation of the program.  If you have already entered
  88. MENU, you will need to reboot your computer and type MENU/nn at the DOS
  89. prompt or if you have MENU in your autoexec.bat, you will have to change the
  90. MENU command in it to MENU/nn.
  91.  
  92.  The only "loose end" is the keyboard entry for ^space.  I couldn't locate
  93. the keyboard codes for this keystroke combination.  (Phone dialer option to
  94. mark an entry to be dialed without the dialing prefix)  If anyone knows how
  95. to do this please let me know.
  96.  
  97.  I hade to implement several mnor differences between the Mocrosoft version and
  98. the Logitech version of the menus.  The Logitech version 3.43 compiler requires
  99. a "TEXT" statement for each "POPUP" menu.  (I simply places TEXT " " after each
  100. POPUP statement.)  Also, the Logitech menu for the "Phone book" menu, the
  101. "Set Com Port" and "Delete Entries and/or Notes" menus would not function
  102. correctly if the SELECT statements attempted to include highlighted screen text.
  103.  
  104.  Thanks to Rick Schaefer (and, in turn, Bob Rapp) for allowing me to Down Load
  105. his mouse menu from the Forbin Project BBS and thus inspiring me to undertake
  106. this venture.
  107.  
  108.  Those of you familiar with mouse programs will know how to change the menus to
  109. suit your specific needs.  I set these up with no color to make sure they
  110. worked with the widest variety of computers (and also because I have a
  111. monochrome monitor).  Well, that's about all I have to say.  Just one more
  112. thing though.
  113.  
  114.   There is NO CHARGE for the use of this menu.  All I ask is that you distribute
  115. this around to those how will find it useful and that you include all the files
  116. from the archive.
  117.  
  118. Any hints and suggestions would be greatly appreciated.  You can reach Rick by
  119. by calling The Monitor BBS and leaving a message.  You can reach me by calling
  120. TriState Online, accessing The Computer Center, PC Bulletin Board Section,
  121. User To User message area and title your message "QMODEM mouse".  If you make
  122. any improvements, let us know.
  123.  
  124.                           Enjoy!!!
  125.  
  126.  
  127. Larry Bennett                                 Rick Schaefer c/o The Monitor
  128. usr2059a@tso.uc.edu                           (317) 643-4585
  129. TriState Online                               FidoNet 1:231/210
  130. (513) 579-1990                
  131. (Use Post office to send a
  132. message to usr2059a)
  133.